home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / utils3 / filer / !Filer- / PinBrdMenu / !Help next >
Text File  |  1995-02-07  |  3KB  |  88 lines
  1.  
  2. if not stated otherwise, all the files referred to in (and including)
  3. this !Help file are located in the !Filer-.PinBrdMenu directory
  4.  
  5.  
  6. Format of the Devices file
  7. ==========================
  8.  
  9. the Devices file is used by Maker to build Filer-'s pinboard menu
  10. 'database' (the Data file)
  11.  
  12. for each menu item, Devices must provide two lines
  13. - 'device specification' of the device associated with the item
  14. - a sprite name
  15.  
  16.  
  17. example: you want to be able to access the ADFS floppy disc drive 0
  18.          from Filer-'s pinboard menu
  19.  
  20. Devices must contain the two lines
  21.  
  22. ADFS::0
  23. f-floppy
  24.  
  25. this 'associates' a pinboard menu item with the ADFS floppy disc drive 0.
  26. if you click upon the item, the ADFS::0.$ directory will be opened.
  27. when the pointer is over it and you go ⇨, a Filer- menu for the ADFS::0.$
  28. directory will pop up
  29.  
  30. when the pointer is NOT over this item, the sprite f-floppy
  31. will be displayed in the pinboard menu.
  32.  
  33. when the pointer IS over the item, the sprite f-floppy'
  34. will be displayed instead.
  35.  
  36. both sprites should exist in the Sprites file
  37. if the 1st doesn't, you won't see the device at all in Filer-'s PinBoard menu
  38. if the 2nd doesn't, you won't see that the device is 'selected'
  39.  
  40. the sequence of items in the Devices file determines
  41. the sequence of items in Filer-'s pinboard menu
  42.  
  43. empty lines in Devices are ignored and so are leading
  44. characters with codes <= 32 (ASC" ")
  45.  
  46. a device specification is of the form:
  47.  
  48.         <filing system name>::<drive number or name>
  49.  
  50. :<drive number or name> is optional
  51.  
  52. if you omit it (you can for eg. RAMFS, do not for eg. hard disc),
  53. Filer- will access the root directory ($) on the *Configure'd drive
  54. for the given filing system
  55.  
  56. a valid specification must not contain certain characters (see User Guide).
  57. this is not checked for rigorously, but the string is scanned only up to
  58. the first character <= " " and any stuff after it is ignored and can be left
  59. there as a comment. sprite names are scanned the same way
  60.  
  61. a line must not be longer than 255 characters
  62.  
  63. to create Data, 2click on !Make
  64.  
  65. --
  66.  
  67. you can create Data by hand. it's plain text, typed as 'data'
  68.  
  69. the format is:
  70.                                        - this line does not belong to Data
  71. number of items (say N)
  72. device spec 1
  73. .
  74. ...
  75. .
  76. device spec N
  77. Ssprite name 1,sprite name 1'
  78. .
  79. ...
  80. .
  81. Ssprite name N,sprite name N'
  82.  
  83. the list must not contain empty lines before the 1st line and the last one
  84. each line is terminated by a line feed char (ASCII 10)
  85.  
  86. Ssprite name i,sprite name i' is nothing else but the validation
  87. string for the pinboard menu item i
  88.